home *** CD-ROM | disk | FTP | other *** search
/ Floppyshop 2 / Floppyshop - 2.zip / Floppyshop - 2.iso / diskmags / 0022-3.564 / dmg-3446 / programs / 68ktogfa / 68000gfa.doc next >
Text File  |  1987-04-21  |  4KB  |  103 lines
  1.                       
  2.                          68000 To GFA BASIC
  3.                          Conversion Utility
  4.  
  5.                                  By
  6.  
  7.                           Craig Smith 1991
  8.  
  9.  -----------------------------------------------------------------
  10.                            Introduction...
  11.  -----------------------------------------------------------------
  12.   To follow up on ST Format's GFA Basic Tutorial Series I decided
  13.   to make a fast and powerful utility for converting Machine Code
  14.   Routines to Basic Equivalent.  For example let's say you want to
  15.   add the 'BASCODE.EXE' Routine (Supplied with Most Samplers) to 
  16.   your GFA Basic Masterpiece, you could use this utility to do that.
  17.   You could even write animation routines in Assembler and converge
  18.   them with your Basic to improve your program.  For those who 
  19.   do not know 68000 Machine Code, then get Stuck In with Peter
  20.   Molyneux's Assembler series in ST Format.  Note that you will
  21.   also need an Assembler Package to get the best out of this utility.
  22.   Luckily enough ST Format is giving away Devpac ST On the Coverdisk,
  23.   so there is no reason why you can't write a scorcher of a game
  24.   becuase you have all the Utilities for the Purpose and one of
  25.   Britain's top Programmers teaching you all you need to know!!!
  26.       
  27.   -----------------------------------------------------------------
  28.                         Files On Disk...
  29.   -----------------------------------------------------------------
  30.   You should have the following files with this utility:
  31.  
  32.   68000GFA.PRG     -     The Conversion Program itself.
  33.   ROUTINE.S        -     An example assembler file which inverts.
  34.                          the screen when called.
  35.   68000GFA.DOC     -     This text you are reading!
  36.   EXAMPLE.BAS      -     An example GFA Basic File to 'Poke' and
  37.                          call the source above.
  38.  
  39.   -----------------------------------------------------------------
  40.                         Using the Program...
  41.   -----------------------------------------------------------------
  42.   Using this Program could not be easier!  Simply Load it from 
  43.   desktop and when the Program has loaded simply follow onscreen
  44.   prompts.
  45.  
  46.   -----------------------------------------------------------------
  47.                          Beginners Guide...
  48.   -----------------------------------------------------------------
  49.   For those totally lost and that don't know how to start follow
  50.   these steps and you should be okay:
  51.  
  52.   1.  Assemble The Example Source File Given with this Program
  53.       using DEVPAC.
  54.  
  55.   2.  Load in the Converter Program.
  56.  
  57.   3.  When asked for a source file, insert your disk containing
  58.       the assembled file and select the file.
  59.  
  60.   4.  The screen will flash yellow and red whilst the Conversion
  61.       Process is taking Place.
  62.  
  63.   5.  When the Conversion has taken place, you will be asked
  64.       for an output filename.  The extension must be LST so that
  65.       GFA-BASIC can Merge it.
  66.  
  67.   6.  Save the Output file and load up GFA-BASIC.
  68.  
  69.   7.  Load EXAMPLE.BAS by Pressing F1.
  70.  
  71.   8.  Move Cursor to end of EXAMPLE.BAS and insert the disk 
  72.       containing the file created above.
  73.  
  74.   9.  Press F2 to Merge, then wait.
  75.  
  76.   10. After it has merged you should see DATA Statements appear.
  77.  
  78.   11. Run The Program and thats all there is to it!
  79.  
  80.  ----------------------------------------------------------------------
  81.                      Hints on Writing Routines
  82.  ----------------------------------------------------------------------
  83.   The Programmer must pay attention to the following points when
  84.   using machine routines in GFA-BASIC:
  85.  
  86.   1.  End your routine with RTS to hand control back to GFA-BASIC.
  87.   2.  Make sure your routines are position independant and if they
  88.       are not Position indepedant that they are poked to the 
  89.       proper start address.
  90.   3.  GFA-BASIC puts the routines in user mode when it calls them,
  91.       so you must ensure that they put themselfs in SUPERVISOR
  92.       mode if they need to.
  93.  
  94.  ----------------------------------------------------------------------
  95.  
  96.  Finally I hope that Programmers, find this useful as a supplement
  97.  to ST Format's GFA-BASIC Tutorials and Assembler Tutorials.  Finally
  98.  who know's maybe you could write a format Gold or a decent animation
  99.  demo and even if you don't, this Utility will provide you with an
  100.  handy tool for Future use.  Have Fun...
  101.  
  102.   
  103.